home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_qt.idb / usr / freeware / catman / p_man / cat3 / qdatetime.Z / qdatetime
Encoding:
Text File  |  1998-10-28  |  18.7 KB  |  265 lines
  1.  
  2.  
  3.  
  4.      QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee((((3333qqqqtttt))))    TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))    QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee((((3333qqqqtttt))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       QDateTime - Combines QDate and QTime into a single class
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.       #include <qdatetime.h>
  13.  
  14.     PPPPuuuubbbblllliiiicccc MMMMeeeemmmmbbbbeeeerrrrssss
  15.       QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee (((())))
  16.       QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee (((( ccccoooonnnnsssstttt QQQQDDDDaaaatttteeee &&&& ))))
  17.       QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee (((( ccccoooonnnnsssstttt QQQQDDDDaaaatttteeee &&&&,,,, ccccoooonnnnsssstttt QQQQTTTTiiiimmmmeeee &&&& ))))
  18.       bbbboooooooollll iiiissssNNNNuuuullllllll (((()))) ccccoooonnnnsssstttt
  19.       bbbboooooooollll iiiissssVVVVaaaalllliiiidddd (((()))) ccccoooonnnnsssstttt
  20.       QQQQDDDDaaaatttteeee    ddddaaaatttteeee (((())))    ccccoooonnnnsssstttt
  21.       QQQQTTTTiiiimmmmeeee    ttttiiiimmmmeeee (((())))    ccccoooonnnnsssstttt
  22.       vvvvooooiiiidddd sssseeeettttDDDDaaaatttteeee (((( ccccoooonnnnsssstttt QQQQDDDDaaaatttteeee &&&& ddddaaaatttteeee ))))
  23.       vvvvooooiiiidddd sssseeeettttTTTTiiiimmmmeeee (((( ccccoooonnnnsssstttt QQQQTTTTiiiimmmmeeee &&&& ttttiiiimmmmeeee ))))
  24.       vvvvooooiiiidddd sssseeeettttTTTTiiiimmmmeeee____tttt (((( uuuuiiiinnnntttt    sssseeeeccccssssSSSSiiiinnnncccceeee1111JJJJaaaannnn1111999977770000UUUUTTTTCCCC ))))
  25.       QQQQSSSSttttrrrriiiinnnngggg ttttooooSSSSttttrrrriiiinnnngggg (((()))) ccccoooonnnnsssstttt
  26.       QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee aaaaddddddddDDDDaaaayyyyssss (((( iiiinnnntttt ddddaaaayyyyssss )))) ccccoooonnnnsssstttt
  27.       QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee aaaaddddddddSSSSeeeeccccssss (((( iiiinnnntttt sssseeeeccccssss )))) ccccoooonnnnsssstttt
  28.       iiiinnnntttt ddddaaaayyyyssssTTTToooo (((( ccccoooonnnnsssstttt QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee &&&& )))) ccccoooonnnnsssstttt
  29.       iiiinnnntttt sssseeeeccccssssTTTToooo (((( ccccoooonnnnsssstttt QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee &&&& )))) ccccoooonnnnsssstttt
  30.       bbbboooooooollll ooooppppeeeerrrraaaattttoooorrrr======== (((( ccccoooonnnnsssstttt QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee &&&& ddddtttt )))) ccccoooonnnnsssstttt
  31.       bbbboooooooollll ooooppppeeeerrrraaaattttoooorrrr!!!!==== (((( ccccoooonnnnsssstttt QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee &&&& ddddtttt )))) ccccoooonnnnsssstttt
  32.       bbbboooooooollll ooooppppeeeerrrraaaattttoooorrrr<<<< (((( ccccoooonnnnsssstttt QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee &&&& ddddtttt    )))) ccccoooonnnnsssstttt
  33.       bbbboooooooollll ooooppppeeeerrrraaaattttoooorrrr<<<<==== (((( ccccoooonnnnsssstttt QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee &&&& ddddtttt )))) ccccoooonnnnsssstttt
  34.       bbbboooooooollll ooooppppeeeerrrraaaattttoooorrrr>>>> (((( ccccoooonnnnsssstttt QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee &&&& ddddtttt    )))) ccccoooonnnnsssstttt
  35.       bbbboooooooollll ooooppppeeeerrrraaaattttoooorrrr>>>>==== (((( ccccoooonnnnsssstttt QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee &&&& ddddtttt )))) ccccoooonnnnsssstttt
  36.  
  37.     SSSSttttaaaattttiiiicccc PPPPuuuubbbblllliiiicccc MMMMeeeemmmmbbbbeeeerrrrssss
  38.       QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee ccccuuuurrrrrrrreeeennnnttttDDDDaaaatttteeeeTTTTiiiimmmmeeee (((())))
  39.  
  40.      RRRREEEELLLLAAAATTTTEEEEDDDD FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN DDDDOOOOCCCCUUUUMMMMEEEENNNNTTTTAAAATTTTIIIIOOOONNNN
  41.       (Note    that these are not member functions.)
  42.       QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm &&&&    ooooppppeeeerrrraaaattttoooorrrr<<<<<<<< ((((QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm    &&&& _s,,,, ccccoooonnnnsssstttt QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee &&&&
  43.           _d_t))))
  44.       QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm &&&&    ooooppppeeeerrrraaaattttoooorrrr>>>>>>>> ((((QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm    &&&& _s,,,, QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee &&&& _d_t))))
  45.  
  46.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  47.       The QDateTime    class combines QDate and QTime into a single
  48.       class.
  49.  
  50.       QDateTime provides high precision date and time functions
  51.       since    it can work with Gregorian dates up to about year
  52.       8000.
  53.  
  54.       Most countries that use the Gregorian    calendar switched to
  55.       it between 1550 and 1920.
  56.  
  57.       See also: QDate and QTime.
  58.  
  59.      MMMMEEEEMMMMBBBBEEEERRRR FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN DDDDOOOOCCCCUUUUMMMMEEEENNNNTTTTAAAATTTTIIIIOOOONNNN
  60.  
  61.  
  62.  
  63.      PPPPaaaaggggeeee 1111                         ((((pppprrrriiiinnnntttteeeedddd 9999////22222222////99998888))))
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee((((3333qqqqtttt))))    TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))    QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee((((3333qqqqtttt))))
  71.  
  72.  
  73.  
  74.      QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee::::::::QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee (((())))
  75.       Constructs a null datetime (i.e. null    date and null time). A
  76.       null datetime    is invalid, since the date is invalid.
  77.  
  78.      QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee::::::::QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee (((( ccccoooonnnnsssstttt QQQQDDDDaaaatttteeee    &&&& ddddaaaatttteeee ))))
  79.       Constructs a datetime    with date _d_a_t_e and null    time
  80.       (00:00:00.000).
  81.  
  82.      QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee::::::::QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee (((( ccccoooonnnnsssstttt QQQQDDDDaaaatttteeee    &&&& ddddaaaatttteeee,,,,    ccccoooonnnnsssstttt QQQQTTTTiiiimmmmeeee &&&& ttttiiiimmmmeeee ))))
  83.       Constructs a datetime    with date _d_a_t_e and time    _t_i_m_e.
  84.  
  85.      QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee::::::::aaaaddddddddDDDDaaaayyyyssss (((( iiiinnnntttt    nnnnddddaaaayyyyssss ))))    ccccoooonnnnsssstttt
  86.       Returns the datetime plus _n_d_a_y_s days.
  87.  
  88.       See also: daysTo().
  89.  
  90.      QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee::::::::aaaaddddddddSSSSeeeeccccssss (((( iiiinnnntttt    nnnnsssseeeeccccssss ))))    ccccoooonnnnsssstttt
  91.       Returns the datetime plus _n_s_e_c_s seconds.
  92.  
  93.       See also: secsTo().
  94.  
  95.      QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee::::::::ccccuuuurrrrrrrreeeennnnttttDDDDaaaatttteeeeTTTTiiiimmmmeeee (((()))) [[[[ssssttttaaaattttiiiicccc]]]]
  96.       Returns the current datetime.
  97.  
  98.       See also: QDate::currentDate() and QTime::currentTime().
  99.  
  100.      QQQQDDDDaaaatttteeee QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee::::::::ddddaaaatttteeee (((()))) ccccoooonnnnsssstttt
  101.       Returns the date part    of this    datetime.
  102.  
  103.       See also: time().
  104.  
  105.      iiiinnnntttt QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee::::::::ddddaaaayyyyssssTTTToooo (((( ccccoooonnnnsssstttt QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee &&&& ddddtttt )))) ccccoooonnnnsssstttt
  106.       Returns the number of    days from this datetime    to _d_t, which
  107.       is negaitive if _d_t is    in the past.
  108.  
  109.       See also: addDays() and secsTo().
  110.  
  111.      bbbboooooooollll QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee::::::::iiiissssNNNNuuuullllllll (((()))) ccccoooonnnnsssstttt
  112.       Returns TRUE if both the date    and the    time are null. A null
  113.       date is invalid.
  114.  
  115.       See also: QDate::isNull() and    QTime::isNull().
  116.  
  117.      bbbboooooooollll QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee::::::::iiiissssVVVVaaaalllliiiidddd (((())))    ccccoooonnnnsssstttt
  118.       Returns TRUE if both the date    and the    time are value.
  119.  
  120.       See also: QDate::isValid() and QTime::isValid().
  121.  
  122.      bbbboooooooollll QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee::::::::ooooppppeeeerrrraaaattttoooorrrr!!!!====    (((( ccccoooonnnnsssstttt    QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee &&&& ddddtttt )))) ccccoooonnnnsssstttt
  123.       Returns TRUE if this datetime    is different from _d_t, or FALSE
  124.       if they are equal.
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                         (printed 9/22/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee((((3333qqqqtttt))))    TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))    QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee((((3333qqqqtttt))))
  137.  
  138.  
  139.  
  140.       See also: operator==().
  141.  
  142.      bbbboooooooollll QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee::::::::ooooppppeeeerrrraaaattttoooorrrr<<<< (((( ccccoooonnnnsssstttt QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee &&&& ddddtttt ))))    ccccoooonnnnsssstttt
  143.       Returns TRUE if this datetime    is before _d_t, otherwise    FALSE.
  144.  
  145.      bbbboooooooollll QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee::::::::ooooppppeeeerrrraaaattttoooorrrr<<<<====    (((( ccccoooonnnnsssstttt    QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee &&&& ddddtttt )))) ccccoooonnnnsssstttt
  146.       Returns TRUE if this datetime    is before or equal to _d_t,
  147.       otherwise FALSE.
  148.  
  149.      bbbboooooooollll QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee::::::::ooooppppeeeerrrraaaattttoooorrrr========    (((( ccccoooonnnnsssstttt    QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee &&&& ddddtttt )))) ccccoooonnnnsssstttt
  150.       Returns TRUE if this datetime    is equal to _d_t,    or FALSE if
  151.       they are different.
  152.  
  153.       See also: operator!=().
  154.  
  155.      bbbboooooooollll QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee::::::::ooooppppeeeerrrraaaattttoooorrrr>>>> (((( ccccoooonnnnsssstttt QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee &&&& ddddtttt ))))    ccccoooonnnnsssstttt
  156.       Returns TRUE if this datetime    is after _d_t, otherwise FALSE.
  157.  
  158.      bbbboooooooollll QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee::::::::ooooppppeeeerrrraaaattttoooorrrr>>>>====    (((( ccccoooonnnnsssstttt    QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee &&&& ddddtttt )))) ccccoooonnnnsssstttt
  159.       Returns TRUE if this datetime    is equal to or after _d_t,
  160.       otherwise FALSE.
  161.  
  162.      iiiinnnntttt QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee::::::::sssseeeeccccssssTTTToooo (((( ccccoooonnnnsssstttt QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee &&&& ddddtttt )))) ccccoooonnnnsssstttt
  163.       Returns the number of    seconds    from this datetime to _d_t,
  164.       which    is negative if _t is in the past.
  165.  
  166.       Example:
  167.  
  168.           QDateTime    dt = QDateTime::currentDateTime();
  169.           QDateTime    x( QDate(dt.year(),12,24), QTime(17,00)    );
  170.           debug( "There are    %d seconds to Christmas", dt.secsTo(x) );
  171.  
  172.       See also: addSecs(), daysTo()    and QTime::secsTo().
  173.  
  174.      vvvvooooiiiidddd QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee::::::::sssseeeettttDDDDaaaatttteeee (((( ccccoooonnnnsssstttt QQQQDDDDaaaatttteeee &&&& ddddaaaatttteeee ))))
  175.       Sets the date    part of    this datetime.
  176.  
  177.       See also: setTime().
  178.  
  179.      vvvvooooiiiidddd QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee::::::::sssseeeettttTTTTiiiimmmmeeee (((( ccccoooonnnnsssstttt QQQQTTTTiiiimmmmeeee &&&& ttttiiiimmmmeeee ))))
  180.       Sets the time    part of    this datetime.
  181.  
  182.       See also: setDate().
  183.  
  184.      vvvvooooiiiidddd QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee::::::::sssseeeettttTTTTiiiimmmmeeee____tttt (((( uuuuiiiinnnntttt sssseeeeccccssssSSSSiiiinnnncccceeee1111JJJJaaaannnn1111999977770000UUUUTTTTCCCC ))))
  185.       Sets the local date and time given the number    of seconds
  186.       that have passed since 00:00:00 on January 1,    1970,
  187.       Coordinated Universal    Time (UTC). On systems that do not
  188.       support timezones this function will behave as if local time
  189.       were UTC.
  190.  
  191.      QQQQTTTTiiiimmmmeeee QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee::::::::ttttiiiimmmmeeee (((()))) ccccoooonnnnsssstttt
  192.  
  193.  
  194.  
  195.      PPPPaaaaggggeeee 3333                         ((((pppprrrriiiinnnntttteeeedddd 9999////22222222////99998888))))
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee((((3333qqqqtttt))))    TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))    QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee((((3333qqqqtttt))))
  203.  
  204.  
  205.  
  206.       Returns the time part    of this    datetime.
  207.  
  208.       See also: date().
  209.  
  210.      QQQQSSSSttttrrrriiiinnnngggg QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee::::::::ttttooooSSSSttttrrrriiiinnnngggg (((()))) ccccoooonnnnsssstttt
  211.       Returns the datetime as a string.
  212.  
  213.       The string format is "Sat May    20 1995    03:40:13".
  214.  
  215.      RRRREEEELLLLAAAATTTTEEEEDDDD FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN DDDDOOOOCCCCUUUUMMMMEEEENNNNTTTTAAAATTTTIIIIOOOONNNN
  216.      QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm &&&& ooooppppeeeerrrraaaattttoooorrrr<<<<<<<< ((((QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm &&&& ssss,,,,    ccccoooonnnnsssstttt QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee    &&&& ddddtttt))))
  217.       Writes a datetime to the stream.
  218.  
  219.       Serialization    format:    [QDate QTime].
  220.  
  221.      QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm &&&& ooooppppeeeerrrraaaattttoooorrrr>>>>>>>> ((((QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm &&&& ssss,,,,    QQQQDDDDaaaatttteeeeTTTTiiiimmmmeeee &&&& ddddtttt))))
  222.       Reads    a datetime from    the stream.
  223.  
  224.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  225.       hhhhttttttttpppp::::////////wwwwwwwwwwww....ttttrrrroooollllllll....nnnnoooo////qqqqtttt////qqqqddddaaaatttteeeettttiiiimmmmeeee....hhhhttttmmmmllll
  226.  
  227.      CCCCOOOOPPPPYYYYRRRRIIIIGGGGHHHHTTTT
  228.       Copyright 1992-1997 Troll Tech AS.  See the LICENSE file
  229.       included in the distribution for a complete license
  230.       statement.
  231.  
  232.      AAAAUUUUTTTTHHHHOOOORRRR
  233.       Generated automatically from the source code.
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.      Page 4                         (printed 9/22/98)
  262.  
  263.  
  264.  
  265.